home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 029a / masview.zip / READ.ME < prev    next >
Text File  |  1991-10-23  |  5KB  |  119 lines
  1.                               MASTERVIEW Demo Disk
  2.                               --------------------
  3.  
  4.         This disk contains a demonstration version of  MasterView.  While 
  5.         all  features  of MasterView are active, the demo  program  works 
  6.         only with the supplied target files (TTT*.C).
  7.  
  8.         You  can  get the general feel of MasterView by taking  a  "self-
  9.         guided  demo tour". This will only take a couple of  minutes  and 
  10.         will  cover the main functions quickly. It may be handy to  print 
  11.         this  file  and refer to the hardcopy as you go. (It  is  only  a 
  12.         couple of pages long).
  13.  
  14.         To show off MasterView's user interface, we have assumed you  are 
  15.         using a mouse and a color monitor. If you are not, MasterView can 
  16.         be operated using the ALT-keys, ALT-S for Search, etc. Your mouse 
  17.         driver should be loaded before starting MasterView.
  18.  
  19.         In  the following text, the lines starting with -->  are  actions 
  20.         you should take.
  21.  
  22.         --> To get ready for your tour, make a new directory on your hard 
  23.         disk, and copy all files from the MasterView demo disk into it.
  24.  
  25.         Start the MasterView program...
  26.  
  27.         --> type  MV  and press Enter
  28.  
  29.         MasterView starts and displays the file screen.
  30.  
  31.         You  should have a display of six files (one .h file and five  .c 
  32.         files).  These files contain the C source code for a  Tic-Tac-Toe 
  33.         game. You, of course, are completely unfamilier with the contents 
  34.         of these files.
  35.  
  36.         The yellow diamond at the upper left is the mouse cursor.
  37.  
  38.         -->  put the mouse cursor on 'Search' and click the left button
  39.  
  40.         to  go  to  the Search screen. Your screen will  clear  and  show 
  41.         MasterView ready to search the files. Let's say we are interested 
  42.         in  changing  the  screen  display of the  game  but  don't  know 
  43.         anything about this particular implementation of it.
  44.  
  45.         Since  we  know that Tic-Tac-Toe is played with O's and  X's,  we 
  46.         will  search  for an X to see how and where the  program  prints. 
  47.         (Notice that we are using a capital X (in upper case) here...)
  48.  
  49.         --> type  X <Enter>
  50.  
  51.         MasterView searches for 'X'...
  52.  
  53.         We see that 'X' is found in two files. The 'X' in TTT1.C is  some 
  54.         kind of greeting, and the 'X' in TTT2.C looks like it prints  the 
  55.         Tic-Tac-Toe board. Notice that it uses the C function 'printf()'. 
  56.  
  57.         If that's how it prints, let's try to get an overview of printing 
  58.         by finding all of the printf() calls.
  59.  
  60.         --> type  printf <Enter>
  61.  
  62.         MasterView searches for printf...
  63.  
  64.         We see that 'printf' is used in four files. We can easily see the 
  65.         greeting, where moves are announced, and what looks like the Tic-
  66.         Tac-Toe board display in TTT2.C. Want a closer look?
  67.  
  68.         --> put the mouse cursor inside the TTT2.C window and click left
  69.  
  70.         Now we have Zoomed in on TTT2.C. The lines containing 'HUMAN' and 
  71.         'COMPUTER' look interesting...
  72.  
  73.         --> click left mouse on HUMAN or COMPUTER
  74.  
  75.         We  can  now see the heart of the code that  prints  the  playing 
  76.         board. A variable named 'board' is being used...
  77.  
  78.         --> click your right mouse button...
  79.  
  80.         --> click your right mouse button again...
  81.  
  82.         and you are back at the Search screen.
  83.  
  84.         --> type  board <Enter>
  85.  
  86.         and you can see all uses of 'board' in the program. Some are  for 
  87.         our  variable and some are functions called  'print_board()'  and 
  88.         'set_up_board()'. You can Zoom on anything interesting and  check 
  89.         it out, or search for other things you notice. (If you happen  to 
  90.         find your way into the editor, you can exit by pressing ESC.)
  91.  
  92.         --> exit by clicking right mouse button repeatedly
  93.  
  94.         When  you are finished looking around, clicking the  right  mouse 
  95.         button  will  back you out from wherever you are one  step  at  a 
  96.         time,  until you are at the File screen. MasterView then asks  if 
  97.         you are ready to exit... press 'Y' and you are done.
  98.  
  99.         This  is  the  basics  of how we  use  MasterView  to  build  our 
  100.         knowledge  of an unfamilier program. Note that we have been  able 
  101.         to  explore  without worrying about program  organization,  about 
  102.         what  the various files are named, where things are kept, or  any 
  103.         other  messy  details... and we haven't had to type  any  command 
  104.         lines to do it. When we are ready to make a change we can quickly 
  105.         find  the area we are concerned with; and if we need to  alter  a 
  106.         variable  or function, we can see everywhere that it is used  and 
  107.         won't miss any references.
  108.  
  109.         MasterView   can  help  you  do  your  job  more  quickly,   more 
  110.         accurately, and with less frustration. It is available from:
  111.  
  112.                                  CodeWorks, Inc.
  113.                                  PO Box 47-334
  114.                                  Plymouth MN 55447
  115.  
  116.                                  (612) 557-9358
  117.  
  118.         Thank you for trying this demonstration.
  119.